home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / extr102.zip / EXTRACT.DOC next >
Text File  |  1993-05-25  |  5KB  |  129 lines
  1.  
  2.     EXTRACT.EXE is a program to convert a QWK packet to ASCII.
  3.  
  4.     Why would you want to do this?  I have thought of a few reasons.
  5.  
  6.     For those of us interested in the CUISINE, RECIPE, GOURMET
  7. conferences, an ASCII conversion of the conference can be read by
  8. MEALMASTER and the message's recipes that are in MEALMASTER format
  9. extracted quickly and painlessly.  Of course, you have to go back later to
  10. pick up the chit-chat and non-MEALMASTER recipes.  But when pressed for
  11. time...
  12.  
  13.     Another use is in STORY conferences.  It is tedious to read long
  14. stories with a reader.  With this program you can convert the conference to
  15. a text file and print it out to read.
  16.  
  17.     Going to be away from a computer for a while?  Download, convert and
  18. print your messages to take with you.
  19.  
  20.     The program when run without parameters gives the following help
  21. information:
  22.  
  23.    version 1.01 QWK packet to ASCII by Rodney Grantham
  24.  
  25.  Usage: C:\TC\FILES\EXTRACT.EXE conferencenumber [outfile]
  26.  
  27.    Either unpack MESSAGES.DAT from .QWK packet or
  28.    run the program in your mail reader's work space
  29.    and copy the output file to another directory.
  30.  
  31.    conferencenumber of 9999 means convert all messages.
  32.  
  33.    Message files are created for groups of about 50 pages
  34.    of output each.  Messages aren't split across files.
  35.  
  36.  
  37.     If the program is renamed, the new name will display in the help
  38. message.
  39.  
  40.     MESSAGES.DAT is the section of a QWK packet with your messages in it.
  41. The program looks for this when run and converts it.  If the CONTROL.DAT
  42. file is found, the BBS name will be read from it.  Otherwise, default will
  43. fill in with: BBS: QWK to ASCII by EXTRACT 1.01.
  44.  
  45.     The second parameter is the conference number.  Integer values are used
  46. in the program.  9999 was selected as an arbitrary indicator for 'ALL'
  47. conferences.  I have heard rumor of boards with thousands of conferences.
  48. If you encounter a problem with this convention, let me know.
  49.  
  50.     If you are only interested in CUISINE, conference 333.  Then enter, for
  51. example:
  52.  
  53.     EXTRACT 333.
  54.  
  55.     By default the output file is:  QWKmmdd.1.  mmdd representing 2 digit
  56. month and day, of course.  You may enter your own outfile as the second
  57. parameter.  After about 50 standard printer size pages of messages are
  58. written to the file, a new file with the same base and '.2' is created.
  59. Messages are not split between files so the size of the output files
  60. varies somewhat.  Successive files are numbered similarly.
  61.  
  62.     A message with the file name and the messages it contains is printed as
  63. each file is closed.  Filenames for which there are existing files are
  64. skipped.  To write to CUIS0201.1 (conference name & date to keep
  65. files straight) enter:
  66.  
  67.     EXTRACT 333 CUIS0201.1
  68.  
  69.     The output file contains a header with a portion of the normal QWK
  70. information which is followed by the full text of the message:
  71.  
  72.  
  73. ============================================================================
  74. BBS:  QWK to ASCII by EXTRACT 1.01
  75. Date: 03-07-93    Number: 1133
  76. From: RODNEY GRANTHAM
  77.   To: ALL
  78. Subj: EXTRACT PROGRAM 1.01
  79. ---------------------------------------------------------------------------
  80.  
  81.  
  82.  
  83.     If you want to register to be notified of upgrades, send $3 to:
  84.  
  85.               Rodney Grantham
  86.               770 Cranberry Tr.
  87.               Roswell, GA 30076
  88.  
  89.     Please include the version number which displays when EXTRACT is run
  90. without any parameters.
  91.  
  92.     If you have suggestions send them to the same address.  The current
  93. program does what I need.  If there is interest, I can think of a number of
  94. enhancements:
  95.  
  96.          User control of size of files when split or override of
  97.          splitting of files.
  98.  
  99.          Ability to skip short messages.  This would be handy to
  100.          skip the chit-chat in a message conference.  Would
  101.          require that message title be tracked to avoid skipping
  102.          a short conclusion to a story.
  103.  
  104.          Program to use ALL rather than the arbitrary number for
  105.          all conferences.  My assumption is that generally one
  106.          conference will be converted.  This 9999 was just added
  107.          for generality.
  108.  
  109.  
  110.     If you use the program and don't want to register, drop me a postcard
  111. anyway.  Include any comments.  I'd like to track the spread and usage just
  112. out of curiousity.  At least splurge enough to blow a quarter.
  113.  
  114.     ------------------------------------------------------------
  115.  
  116.     I want to acknowledge the use of Patrick Y. Lee's excellent
  117. QWKLAY15.zip which includes extensive information on QWK file format.  The
  118. documentation says latest version can be found on: Aardvark BBS (NY, NY) at
  119. 212-496-8324.  Also Lunatic Fringe (Plano TX) 214-422-2936.  Both provide
  120. first time callers download privileges.
  121.  
  122.     An abbreviated version of this file called QWKLAYOT.zip which I don't
  123. think acknowledges Patrick Lee was my first encounter with this.  If you
  124. have that, trust me that Patrick Lee's version is much more extensive and
  125. worth the trouble of looking for.
  126.  
  127.     The QWK format is copyrighted by Sparkware 1987.
  128.  
  129.